INSTALLING

Download the RiscLua distribution from http://www.wra1th.plus.com/lua/risclua.html!lua icon. Unzip the latest application !rlua... from it, and save it to wherever you like. The Apps directory or !Boot.Resources are convenient because that will ensure that !rlua... gets filer_booted when you start up. Filer_booting !rlua... will create the filetype Lua (&18C) Lua filetype icon and set up various system variables.

You should be aware that RiscLua has passed through many versions, so that there can be issues of compatibility. If in doubt download the latest version.

Doubleclicking on !rlua... will install it on the iconbar. Clicking the iconbar icon with Select will open the RiscLua directory, which contains two subdirectories, Examples and Utilities. Clicking the iconbar icon with Adjust will open !rlua... . Dragging a file containing a RiscLua program to the iconbar icon will run it.

The following utilities are included in the full distribution.

Run in a taskwindowDragging any doubleclickable program to TaskW's iconbar icon will run it in a taskwindow. The other utilities require !rlua... to have been filer_booted.

Apply iconApply is only needed if you do not have a recent version of StrongED.

The other three will only be of interest to those who want to know about the internal workings of Lua.

compile iconCompile compiles programs to instructions for lua's virtual machine - this process is carried out automatically as a first step when a program is run. There could in some circumstances be a small saving in time by using Compile first.

disasm icon DisAsm is a disassembler - it displays the instructions in a more readable format.

vmview icon VMview adds this disassembly as interleaved comments to the source program. This can be of use in debugging or profiling a program.